home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / pcb / kmail293.zip / KMAIL.DOC < prev    next >
Text File  |  1992-08-30  |  33KB  |  769 lines
  1.                        Kmail Version  2.93
  2.                          Copyright 1990
  3.                                by
  4.                            Ken Krueger
  5.  
  6.                          Twin  Peaks  BBS
  7.  
  8.              (303)-651-0225 - Hayes Ultra v.32 v.42bis
  9.  
  10. Specifications:
  11. ---------------
  12.  
  13.   Produces QWK compatible mail packets.
  14.   Reads CNAMES.@@@ to obtain conference information.
  15.   Reads TPA to obtain User information.
  16.   Updates USER file via USERS.SYS interface.
  17.   Resets "Mail Waiting" flags after a successful packet download.
  18.   Sets message 'has-been-read" flag after successful download.
  19.   Sets message-has-replies flag when appropriate.
  20.   Fully network compitable. Opens all files in share mode.
  21.   Locks message base during updating.
  22.   Supports 1024 conferences.
  23.   Message packets compatible with RNET.
  24.   Extended conference packets require RNET v1.07 or later.
  25.   Message packets tested with EZ-RDR v1.33 and SLMR v2.0.
  26.   Produces pre-scanned mail packets to save online time.
  27.   Limited file send services for Network hubs.
  28.   Sets the 'Have Mail Waiting' flags during message import.
  29.   BiModem protocol support including bi-directional mode.
  30.   HS/Link protocol support including bi-directional mode.
  31.  
  32.  
  33. Evaluation
  34. ----------
  35.  
  36.   This evaluation  version of  Kmail is  provided so  that you  and your
  37. users may may decide  if this program meets  your needs.  Kmail  is 100%
  38. fully functional for the "sysop" in local mode.  The callers are limited
  39. to 10 messages per conference and to 50 total messages per packet.
  40.  
  41. In addition, you may call Twin Peaks and obtain a one time 60-day full
  42. function demo-key to help complete your evaluation. No fuss no muss,
  43. first time callers can obtain the demo-key.
  44.  
  45.  
  46. 60 Day Demo Key
  47. ---------------
  48.  
  49.   To obtain the 60 day demo key, just call Twin Peaks. Join conf #19
  50. open door 9 and follow the instructions.
  51.  
  52.   In order for the Demo-Key to work, the name you use to register on
  53. Twin Peaks MUST exactly match the name in record #1 of your USERS file.
  54.            ----
  55.  
  56. Requirements
  57. ------------
  58.  
  59.    Dos 3.1 or greater.
  60.    PCBoard 14.5 or 14.5a
  61.    DSZ     version 05/25/89 or later.
  62.    PKZIP   v1.10 or higher.
  63.    PK361   If you wish to support the ARC format.  (optional)
  64.    PUMA    If you wish to make it available.       (optional)
  65.    BiModem If you wish to support it.              (optional)
  66.    HS/Link If you wish to support it.              (optional)
  67.  
  68.  
  69. Communications Ports
  70. --------------------
  71.  
  72.     Channel        I/O Port        Interrupt
  73.       COM1           $3F8            4
  74.       COM2           $2F8            3
  75.       COM3           $3E8            4
  76.       COM4           $2E8            3
  77.       COM5           undefined
  78.       COM6           undefined
  79.       COM7           $2E8            5
  80.       COM8           $3E8            5
  81.  
  82.  
  83. Support for non-standard COM port configurations is provided by
  84. using DOS Set statements as shown below:
  85.  
  86.      SET COMBASE=nnnn   ;port base I/O address.
  87.      SET COMIRQ=n       ;port IRQ setting
  88.  
  89.            NOTE:  nnnn above is expressed as a decimal number!
  90.  
  91.  
  92. Installation for Single Node
  93. ----------------------------
  94.  
  95.       (Refer to NETWORK.DOC file for Multi-Node Installation)
  96.  
  97.    1. Create a KMAIL sub-directory to hold the Kmail distribution files.
  98.       Place all files in the archive into this directory.
  99.  
  100.    2. Create a work sub-directory such as C:\KWORK for Kmail to use.
  101.       ***CAUTION***  ***CAUTION***     All files are erased in this
  102.       directory during the mail packet creation process. DO NOT use an
  103.       existing directory that has good stuff in it!  Multi-node systems
  104.       must have a unique work area for each node.
  105.  
  106.    3. Customize the KMAIL.CFG file. Ample comments are in the sample.
  107.       This is where you really customize the overall operation.
  108.       Parms 1-4 are passed along to the mail readers for their use.
  109.       While not critical, you should keep to the general outline in
  110.       the sample and customize them for your system.
  111.  
  112.  ==>  PARM 5: This one is important! This parm specifies the name of
  113.       the QWK mail packet that Kmail will create. While the name can be
  114.       anything, it would be best to have a name that is associated
  115.       with your BBS system name. (Do not specify a .extension here).
  116.  
  117.       The rest of the parms are optional. Among them are options to
  118.       control the number of messages based on connect speed, and
  119.       protocol transfer options. The default values are in the sample.
  120.  
  121.       DSZ is used as the main protocol and is activated via a call
  122.       to a BAT file which you may define in the KMAIL.CFG file. This
  123.       allows you to totally customize the DSZ parms to suit your
  124.       system. I just let it default to the standard PCBxx.BAT files
  125.       that I have setup for PCBoard. Be sure to include the BAT files
  126.       location in your DOS path! Kmail passes parms %1-%5 to the
  127.       BAT files just the same as PCBoard.
  128.  
  129.  
  130.       When a caller requests ╔════════════════════════════════════════╗
  131.       an external protocol,  ║       External Protocol Parameters     ║
  132.       PCBoard passes several ╠═════════╦══════════════════════════════╣
  133.       parameters to the      ║Parameter║         n9scription          ║
  134.       protocol batch file.   ╠═════════╬══════════════════════════════╣
  135.       These parameters are   ║   %1    ║COM Port Number.              ║
  136.       listed to the right.   ╟─────────╫──────────────────────────────╢
  137.                              ║   %2    ║PC to Modem Speed (DTE rate)  ║
  138.                              ╟─────────╫──────────────────────────────╢
  139.                              ║   %3    ║Filename to transfer.         ║
  140.                              ╟─────────╫──────────────────────────────╢
  141.                            * ║   %4    ║Connect Speed shown by PCBoard║
  142.                              ╟─────────╫──────────────────────────────╢
  143.                              ║   %5    ║Carrier Speed.                ║
  144.                              ╟─────────╫──────────────────────────────╢
  145.                              ║   %6    ║Upload Dir Path for BiModem   ║
  146.                              ║         ║and HS/Link type protocols.   ║
  147.                              ╚═════════╩══════════════════════════════╝
  148.  
  149.       * The %4 field is not easily determined within Kmail, therefore
  150.         upon exit to the protocol BAT files, Kmail adjusts the %4
  151.         field to the same value as %5.
  152.  
  153.       I have found the following works well with my Hayes 9600 v.42.
  154.  
  155.         PCBSZ.BAT
  156.               dsz ha bo est 0 %5 pB4096 sz -m %3
  157.  
  158.         PCBRZ.BAT
  159.               dsz ha slow est 0 %5 pB4096 z pr1 rz -m -p %3
  160.  
  161.  
  162.    4. Customize the KMAIL.CNF if necessary. This is a 2 or 3 line file.
  163.       The 1st line defines the interface routine that Kmail should
  164.       use, and the 2nd line defines the location of a work directory.
  165.  
  166.       Line #1 can be ONE of the two following examples:
  167.  
  168.         INTERRUPT   ;the best, fastest, for 99% of all users.
  169.         BIOS        ;if interrupt fails to work under some highly
  170.                     ;unusual multi-tasker configurations, try BIOS.
  171.  
  172.       Line #2 is the path\name of a scratch work directory. If the
  173.       sub-directory does not exist, it will be created. The name may
  174.       be anything. I use the name KWORK on my system.
  175.  
  176.       Line #3 is optional. If the pre-zip function (explained later) is
  177.       used, this line points to the holding sub-directory. It may be
  178.       any name, but I recommend something like KHOLD. Multi-node
  179.       systems MUST share the same KHOLD sub-directory in order for
  180.       pre-zip packets to be located from any node.
  181.  
  182.  
  183.         Sample KMAIL.CNF
  184.  
  185.         INTERRUPT       Line 1
  186.         C:\KWORK        Line 2  <-- Must be unique for each node!
  187.         D:\KHOLD        Line 3  Optional, must NOT be the same as
  188.                                 line 2. Multi-node systems must
  189.                                 share the same sub-directory.
  190.  
  191.   ********************************************************************
  192.   **  Warning   **  Warning  **  Warning  **  Warning  **  Warning  **
  193.   ********************************************************************
  194.   *                                                                  *
  195.   *   ALL FILES ARE ERASED IN THE WORK DIRECTORY DURING PROCESSING.  *
  196.   *   MAKE SURE THE AREA YOU SPECIFY IS A SCRATCH AREA!              *
  197.   *                                                                  *
  198.   ********************************************************************
  199.   **  Warning   **  Warning  **  Warning  **  Warning  **  Warning  **
  200.   ********************************************************************
  201.  
  202.  
  203.    5. Create the BAT file to run the Kmail door. Kmail requires two
  204.       parameters when it is called. The 1st parameter specifies the
  205.       name of the CONFIG file. The 2nd parameter specifies the
  206.       the drive and path to your PCBoard main directory where the
  207.       PCBOARD.DAT file is located.
  208.  
  209.       Echo off
  210.       SET KMAIL=
  211.       CD\Kmail
  212.       KMAIL KMAIL.CNF C:\PCB
  213.       C:
  214.       CD\PCB
  215.       Board
  216.  
  217.  
  218.    6. Add an entry in your DOORS.LST files for Kmail. Indicate that
  219.       a USERS.SYS *SHOULD* be created and that a DOOR.SYS should not
  220.       be created when Kmail is executed.
  221.  
  222.    7. Using PCBSM, select "User Info File Maintenance" and create
  223.       a KMAIL Third Party Application entry with the following info.
  224.  
  225.       Version      :    30
  226.       Static Size  :    18
  227.       Dynamic Size :     1
  228.       Keyword      : KMAIL    <---- Watch this one! See notes below.
  229.  
  230.       NOTE: The keyword parameter above must match the name of the BAT
  231.             file that is used to open the Kmail door. So, if the name
  232.             of your BAT file is something else, change the keyword
  233.             parameter accordingly.
  234.  
  235.       NOTE: If you will be using the PreZip function, then the Keyword
  236.             *must* be KMAIL.     (PreZip is explained later).
  237.  
  238.    8. Kmail will use the DOS Environment variable "COMSPEC=" to locate
  239.       COMMAND.COM in order to execute the archive and communications
  240.       programs. The location of the archive and communication programs
  241.       must also be included in your DOS path.
  242.  
  243.    9. Network Qnet Status:
  244.  
  245.       If your system will be acting as a HUB for other systems, then
  246.       you will need to create a QNET.DAT file to control the Qnet status
  247.       of the downline systems. The QNET.DAT file is a plain ordinary
  248.       text file which contains the names of the downline sysops whom
  249.       you wish to grant Qnet status. One name per line starting in
  250.       column 1 and EXACTLY 1 space between the first and last name.
  251.       Mixed case is ok. The QNET.DAT file should be placed in the
  252.       Kmail sub-directory. Qnet status permits a user to upload mail
  253.       on behalf of another person. Without Qnet status, a user is limited
  254.       to uploading only their own personal mail.
  255.  
  256.       (* ----------------------------------------------------------- *)
  257.       (* The sequence of names should NEVER be changed and new names *)
  258.       (* must only be added to the end of the file. If you need to   *)
  259.       (* remove a person from the list, then just XXX their name out *)
  260.       (* leaving the XXX's as a placeholder.                         *)
  261.       (* ----------------------------------------------------------- *)
  262.  
  263.       NOTE: I apologize for the shoddyness of this procedure. I am
  264.             working on a PCBsm type utility to handle this function.
  265.             It is high on the priority list and expect to have something
  266.             around the middle of 1991.
  267.  
  268.       The letter 'Q' is displayed on the conference selection screen
  269.       beside each conference to indicate Qnet status.
  270.  
  271.       If you have one or more conferences that you do not want echoed
  272.       to downline systems, setting the conference echo-flag to NO will
  273.       disable Qnet status for that conference. Messages can still be
  274.       downloaded for offline reading via a RDR, but cannot be merged
  275.       into the system message base.
  276.  
  277.   10. PRE-ZIP'ed mail packets.
  278.  
  279.       This function allows you to scan and zip a mail packet for a
  280.       user so that it is ready for download when the user calls in.
  281.       This is an especially usefull function for LD callers.
  282.  
  283.       You will need to create a sub-directory to serve as a holding
  284.       area for the pre-zipped packets. The location of the holding
  285.       directory is specified in the Kmail.cnf file as shown in step
  286.       (5) above. Multi-node systems may share the same holding area.
  287.  
  288.       A PREZIP.DAT file must be created in the Kmail sub-directory
  289.       which lists each sysop's name and assigns a unique sequence
  290.       number to each name. The sequence numbers are used to match up
  291.       a pre-zip packet with the proper caller and are not associated
  292.       with any other function in Kmail. Pre-zip packets will be
  293.       stored in the KHOLD directory until downloaded by the caller.
  294.       The users "MSG Pointers" are also stored in the KHOLD directory
  295.       and are posted to the users record upon successful downloading
  296.       of the pre-zip packet.
  297.  
  298. Note: The following format must be *STRICTLY* adheared to. The
  299.       name begins in column #1 and must not exceed 25 characters.
  300.       A comma MUST separate the name and it's following sequence
  301.       number. All names must have a three digit sequence number
  302.       following the name, leading zeros REQUIRED!  Mixed case is
  303.       allowed in the name. No two users should have the same number!
  304.  
  305.    Sample: PREZIP.DAT
  306.  
  307.       George Washington,026
  308.       John Smith,015
  309.       Bob Jones,009
  310.  
  311.  
  312.       I would suggest a SET Kmail= in your door bat file to insure
  313.       that PREZIP is never active for an online caller.
  314.  
  315.       Prezip processing is activated via a Kmail=PREZIP DOS environment
  316.       variable. The following is suggested in your event.sys file.
  317.  
  318.       Basically, the process is to make a call to PCB145 to build a
  319.       USERS.SYS followed by a call to Kmail to create the packet.
  320.  
  321.       Important! The use of : and ; at the appropriate places in the
  322.                  PCB145 command line is critical!!!
  323.  
  324.          Ex:  PCB145 /USERSYS;JOHN;SMITH;PWRD:12345;TPA:KMAIL
  325.                                                         ^^^^^
  326.       Carefull, this parm must match the bat file name.   |
  327.       ____________________________________________________|
  328.  
  329.       EVENT.SYS
  330.       ...
  331.       ...
  332.       Set Kmail=PREZIP              <===== (note CAPS)
  333.       cd\pcb
  334.       PCB145 /USERSYS;JOHN;SMITH;PWRD:12345;TPA:KMAIL
  335.       cd\Kmail
  336.       Kmail KMAIL.CNF C:\PCB LOCAL
  337.       cd\pcb
  338.       PCB145 /USERSYS;JOE;DOAKS;PWRD:FOOBAR;TPA:KMAIL
  339.       cd\Kmail
  340.       Kmail KMAIL.CNF C:\PCB LOCAL
  341.       If Exist USERS.SYS Del USERS.SYS
  342.       Set Kmail=                 <===== Important!! I suggest you also
  343.       ...                               include this line in your Kmail
  344.       ...                               door BAT file(s).
  345.       event continues.....
  346.  
  347.  
  348.   11. The installation of Kmail is now complete and you are ready to
  349.       begin initial testing as soon as everything is backed up!!!
  350.  
  351.  
  352.   12. Insure that the locations of DSZ and PKZxxx programs are defined
  353.       in your DOS path. Kmail will be unable to locate them if they
  354.       are not in the Dos path!
  355.  
  356.  
  357.     **** NOTE WELL **** NOTE WELL **** NOTE WELL **** NOTE WELL ****
  358.     **** NOTE WELL **** NOTE WELL **** NOTE WELL **** NOTE WELL ****
  359.     **** NOTE WELL **** NOTE WELL **** NOTE WELL **** NOTE WELL ****
  360.  
  361.   Obviously a  mail door  must update  the USERS  file to  store message
  362. pointers.  Please make sure your USERS file is backed up before  running
  363. Kmail.  There has  been one report of  trashed message pointers.   I was
  364. unable to track down the cause of the problem and it has not re-occured.
  365.  
  366.   Do not fall  into the trap  of making an  automatic backup each  night
  367. during  your  event  if  you  are  simply overlaying the previous nights
  368. backup.  If  a problem did  occur and you  did not catch  it for several
  369. days, you wouldn't have a valid backup copy.  I suggest that you keep  a
  370. minimum of seven grandfather copies of  your USERS file and each one  of
  371. them should be unique.
  372.  
  373.  
  374. Conferences
  375. -----------
  376.  
  377.   Kmail obtains all conference  related information from the  CNAMES.@@@
  378. file including  such items  as MSG  base location,  required security to
  379. join, and bulletins path/location.
  380.  
  381.   If  a  user  does  not  have  the  required  security  level to join a
  382. conference,  the  conference  will  be  listed  as <closed> on the Kmail
  383. conference selection menu.
  384.  
  385.   If you need to  delete a conference for  any reason, just insure  that
  386. the conference  name is  blanked out  using PCBsetup  and Kmail will not
  387. attempt to  process it.   It  will show  up as  *Empty* on the selection
  388. menu. Remember to do a global delete of the registered and scan flags!
  389.  
  390.  
  391. Private (R/O) Messages
  392. ----------------------
  393.  
  394.   Kmail will validate the caller  security level and compare it  against
  395. the appropriate values specified in  PCBsetup to determine if access  to
  396. to private messages including comments to sysop are allowed.  Conference
  397. Sysop status  is also  checked.   As with  PCBoard, you  may give global
  398. access to private messages by assigning a high enough security, or on  a
  399. conference by conference basis by assigning conference-sysop status.
  400.  
  401.  
  402. Qnet_Private=No/Yes    (Default=No)
  403. -------------------
  404.  
  405.   If you wish to allow  Network-Sysop's the ability to download  private
  406. mail without having to alter security levels, you can do this be putting
  407. the parameter Qnet_Private=Yes in the Kmail.CFG file.  However, R/O msgs
  408. that do not have  the "Echo" flag set,  will not be sent.   In addition,
  409. the same rule  applies to the  conference "Echo-flag" status.   In other
  410. words, for a R/O message to qualify using the Qnet_Private= option, both
  411. the conference Echo flag  AND the individual msg  Echo flag must be  set
  412. on.  Comments to Sysop are not included with this option.
  413.  
  414.  
  415. Ignore_Echo=No/Yes     (Default=No)
  416. ------------------
  417.  
  418.   This option only has meaning if you will be operating as a network hub
  419. with downline nodes receiving mail from  you.  When you enable a  caller
  420. for network-status, that status  only applies to conferences  defined as
  421. "echo" conferences  in pcbsetup.   Besides  "main", you  may have one or
  422. more local conferences on  your system.  If  you wish to allow  downline
  423. nodes  to  echo  your  local  conferences  including main, then set this
  424. option to Yes.
  425.  
  426.  
  427. Mail_Waiting=Yes/No    (Default=Yes)
  428.  
  429.   Use this option to control  whether Kmail will set the  "Mail Waiting"
  430. indicator during message importing.   With this option  enabled, callers
  431. will be notified  of waiting mail  in the various  conferences when they
  432. logon.  This  option will slowdown  the upload process  depending on how
  433. large of a users file you have.  This option causes Kmail to update your
  434. USERS and USERS.INF files, KEEP GOOD BACKUP'S of these files!!!
  435.  
  436.  
  437. Zip_Opt=xxx      (Zip_Opt=-a -es) for example.
  438. -----------
  439.  
  440.   If for some reason you  need/want Kmail to use unique  Zip parameters,
  441. you may specify them using this option.  Omit this entry unless you have
  442. a specific reason for using it.
  443.  
  444.  
  445. Qwk_Dir=path       (Default=None)
  446. Rep_Dir=path       (Default=None)
  447. ------------
  448.  
  449.   If you plan to use Kmail in local mode to capture mail to use with  an
  450. offline RDR, use these parameters  to specify the locations where  Kmail
  451. should place the QWK packet and  where to retrieve the REP file.   These
  452. options are  only for  the convenience  of the  Sysop when  operating in
  453. local mode.   A  DOS copy  command is  issued to  copy the .QWK and .REP
  454. files to/from these directories.
  455.  
  456.  
  457. Scan_Upld_Only=Yes/No   (Default=Yes)
  458. ---------------------
  459.  
  460.   This  option  controls  whether  just  the  upload  directory  or  ALL
  461. directories are scanned when the caller  selects the new file scan.   If
  462. you keep new files in the upload directories for several days/weeks then
  463. setting this option to  YES would be the  best choice.  However,  if you
  464. move new files out of the upload area rather quickly or perhaps have the
  465. "make all uploads private" switch enabled in PCB, then you will need  to
  466. specify NO for this option to prevent callers from missing new files.
  467.  
  468.   The scanning of new  files is limited to  the conference in which  the
  469. door was opened.  Private upload directories are NEVER scanned.
  470.  
  471.  
  472. Tag=
  473. ----
  474.  
  475.   KMail will append a  tag line to messages uploaded via the KMail door.
  476. You may customize the tag information to refelect your bbs info by using
  477. a TAG= parm in the CFG file. Example: Tag=Home of Super BBS
  478.  
  479. The tag information may be up to 60 characters long.
  480.  
  481.  
  482. Disable_Tag=Yes/No      (Default=No)
  483. ------------------
  484.  
  485.   This option may be used to completely disable the adding of TAG lines
  486. to uploaded messages should the need arrise to do so. This option is
  487. ignored in non-registered versions.
  488.  
  489.  
  490. Force_Tag=Yes/No         (Default=No)
  491. ----------------
  492.  
  493.   The tag  information is  normally appended  only on  messages uploaded
  494. into an Echo conference.  Set this option to Yes if you wish to have tag
  495. lines appended to messages in non-echo conferences (including Main).
  496.  
  497.  
  498. Disable_Goodbye=Yes/No   (Default=No)
  499. ----------------------
  500.  
  501.   In the event that you have special processing requirements and  prefer
  502. that callers not logoff directly from KMail, this option is provided  to
  503. disable the (G) command.  When enabled, this option will cause KMail  to
  504. translate all forms of the (G) command into a Quit command.  Upon return
  505. to PCBoard a  PCBSTUFF.KBD file will  be created which  contains a (BYE)
  506. command to log the caller off.  Only systems that are configured to Drop
  507. to Dos after each caller would need this option enabled.
  508.  
  509.  
  510. Disable=nn               (Default=15)
  511. ----------
  512.  
  513.   Use this option  to disable KMail  downloads 'nn' minutes  before your
  514. scheduled system event.  This is used to prevent a user from starting  a
  515. large download and running past the event start time.  Values from  0-60
  516. are accepted here.
  517.  
  518.  
  519. HS/Link and BiModem
  520. -------------------
  521.  
  522.   HS/Link and BiModem are fully supported in bi-directional mode. Obtain
  523. the bulletin from Salt Air for details on installing BiModem. HS/Link is
  524. easily installed with the documentation that comes with it. The standard
  525. PCBxx batch files you setup for these protocols should work just fine
  526. with Kmail.
  527.  
  528.  
  529. KMail Help
  530. ----------
  531.  
  532.   Insure that the file "KMHELP" is placed in the \KMAIL directory.  This
  533. file provides the online help function while in the door.  The help file
  534. can be modified, if nessary, to suit unique environments, but I  suggest
  535. that you don't alter it too much.
  536.  
  537.  
  538. Multi-Lingual Text Files
  539. ------------------------
  540.  
  541.   There is  currently limited  support for  Multi-Lingual files although
  542. the  main  menu  is  not  currently  included.   The following files are
  543. supported.   Just customize  the files  as necessary  and add the proper
  544. language extension.  The files must reside in the KMail directory  along
  545. with the English versions.  Please note that the English versions do not
  546. have an extension.
  547.  
  548.      NEWUSER    (Displayed to first time users)
  549.      KMHELP     (The online help information)
  550.      PNTMSG     (Displayed when user uploads their .PNT
  551.                  file to reset their message pointers)
  552.  
  553.  
  554. SCRIPT0 File
  555. ------------
  556.  
  557.   KMail checks the location specified in PCBSetup for the SCRIPT0  file.
  558. If a SCRIPT0 file is found it  is sent in the mail packet.   The various
  559. rdr's will display the SCRIPT0 file at the end of the rdr session.
  560.  
  561.  
  562. NEWUSER File
  563. ------------
  564.  
  565.   Included in the archive is a  file called NEWUSER, which is a  replica
  566. of the opening display presented to a first time user.  If this new user
  567. screen is satisfactory, you need do nothing.  However, should you desire
  568. to create your own customized message, just edit the sample NEWUSER file
  569. and place it  in the Kmail  directory and Kmail  will display it  rather
  570. than the hard coded text within the program.
  571.  
  572.  
  573. KMAIL.KEY
  574. ---------
  575.  
  576.   This information applies to registered users of KMail that are running
  577. multi-node systems.   If  the BBS  name (as  specified in  PSCsetup) has
  578. different text for each  node, you will need  a KEY file for  each node.
  579. KMail will first check to see  if a KMAIL.KEY exists, and will  use that
  580. if one exists.  If a KMAIL.KEY is not found, then the node # is appended
  581. to the name  and another attempt  is made to  process the KEY  file.  In
  582. other words, Node 1 would look for KMAIL1.KEY and Node 2 would look  for
  583. KMAIL2.KEY and so on.  This approach  will allow you to have all of  the
  584. KEY files in a single directory if you choose to do so.  Of course,  you
  585. still could have a KMAIL.KEY in a unique directory for each node too.
  586.  
  587. NOTE: If at any time  it appears that  your KMAIL.KEY is not functioning
  588.       properly, enter the  character "&" at the  main Kmail  menu screen
  589.       and the  data from the  key will be  displayed  on the terminal to
  590.       assist in the diagnosis of the problem.
  591.  
  592.  
  593. SYSFILE.DAT
  594. -----------
  595.  
  596.   This data file is used to control the sending of data files to network
  597. sysops.  To activate this option, create a SYSFILE.DAT file in the KMail
  598. directory and specify the complete Drive:\Path\Name.ext of the files you
  599. wish to be automatically included within the QWK packet.  The file dates
  600. are checked and  only those with  dates more recent  than the last  file
  601. transmitted are sent.   You may  list up to  24 files, one  FileName per
  602. line starting in column one.  The files will be zipped into  SYSFILE.ZIP
  603. and included in the QWK packet as appropriate.
  604.  
  605.  
  606. Extended Services
  607. -----------------
  608.  
  609.   You can create up to 8 catagories of file services numbered (0-7) that
  610. a user  may subscribe  to.   Files within  the selected  service will be
  611. included in the QWK mail packet.  To implement this function you need to
  612. create a SERVICES.LST file in the KMail subdirectory.  The  SERVICES.LST
  613. file contains a description of each available service.  For each service
  614. create a matching  SERVICEx.DAT file where  x coorsponds to  the service
  615. number.  The SERVICEx.DAT file(s) contains the full drive:\path\name  of
  616. each file contained  in the service  catagory, samples are  shown below.
  617. The SERVICES.LST file is also used as the menu screen when the caller is
  618. selecting their desired services.
  619.  
  620.  
  621.      SERVICES.LST
  622.      ------------
  623.  
  624.      Network News         <== SERVICE0
  625.      BBS Help/Tips        <== SERVICE1
  626.      Conference Listing   <== SERVICE2
  627.  
  628.  
  629.      SERVICE0.DAT               SERVICE1.DAT
  630.      ------------               ------------
  631.      C:\FILES\NET.DOC           E:\SOMEDIR\BBS.HLP
  632.      C:\FILES\NETSTAT.TXT       D:\PCB\HELP\TIPS.TXT
  633.                                 G:\STUFF\MODEM.DOC
  634.  
  635.  
  636.   The above is intended  to show the amount  of flexibility you have  in
  637. creating the various  services.  You  probably will want  to be somewhat
  638. more organized than the example.
  639.  
  640.  
  641.  
  642. Getting Started
  643. ---------------
  644.  
  645.   Finally it's time to run Kmail.   Just login to the BBS in the  normal
  646. way and open  Kmail door.   As a first  time user, you  will be asked to
  647. answer some  configuration questions  as will  each user  when they  try
  648. Kmail the first time.  A  special feature in Kmail will detect  when the
  649. "sysop" is in local mode and  will issue a prompt asking where  to place
  650. the resulting QWK mail  packet.  You should  respond with the drive  and
  651. path, but WITHOUT the  trailing back-slash after the  name.  Use of  the
  652.  
  653. NOTE: Use of  the Loc_Dir option described above prevents having to type
  654.       this information each time you use the door.
  655.  
  656.        c:\temp     \      All of these are valid ways to specify the
  657.        d:\rdr       >--   location of where to place the QWK  packet
  658.        a:          /      when running in local mode.
  659.  
  660.   Later on when you are ready to upload any replies created with one  of
  661. the offline readers, Kmail will ask  where to obtain the REP file.   Use
  662. the same format as above to specify the location.
  663.  
  664.  
  665. Errors
  666. ------
  667.  
  668.   Any errors detected by kmail  including those from 3rd party  programs
  669. such as PKZip  and DSZ are  logged into a  file called $door.err  in the
  670. Kmail sub-directory.  In addition,  many of the errors are  also written
  671. to the  caller log  file.   Error information  is also  displayed to the
  672. callers.
  673.  
  674.  
  675. Notes and Misc Info
  676. -------------------
  677.  
  678.   Kmail  sends  a  bbsid.PNT  file  in  each  mail packet.  The PNT file
  679. contains the last-read message pointer for each conference that the user
  680. has selected.  In the event of a problem, a user may upload the PNT file
  681. to restore the message pointers.   Just extract the KMAIL.PNT  file from
  682. the QWK packet and upload it to Kmail using the 'P' menu option.
  683.  
  684.   The user may select/un-select  conferences and reset message  pointers
  685. by using the  appropriate options in  EZ-RDR.  Review  the documentation
  686. associated  with  EZ-RDR  for  additional  information.   When resetting
  687. message pointers, Kmail will accept an absolute message # or a  negative
  688. number such  as -25  which means  set the  message pointer  equal to  25
  689. messages from the end of the message base.
  690.  
  691.   Not yet documented on the menu screen is the ability to stack commands
  692. for the  download process.   The  command 'D  Y' will  download the mail
  693. packet and return you to the menu screen, while 'D G' will download  and
  694. log you off.  A 10 second timer is provided to allow you to change  your
  695. mind.  By using  stacked commands, the user  can avoid the question  "Do
  696. you wish to receive this packet?"
  697.  
  698.   Recent changes to PCBoard allow for passing command line parms to door
  699. programs. Kmail now takes advantage of this feature. Assuming  Kmail was
  700. installed as door #3, the following commands would be valid.
  701.  
  702.          Open 3 d       (open the door & start download scan)
  703.          Open 3 d y     (open the door, scan mail, yes to download)
  704.          Open 3 d g     (open the door, scan mail, download & goodbye)
  705.         Kmail d y       (open the door, scan mail, yes to download)
  706.         Kmail d y g     (open the door, scan mail, download, goodbye).
  707.  
  708.  
  709.   The following SET commands may be used to adjust the operation
  710.   of Kmail as appropriate.
  711.  
  712. SET PRODEBUG=ON
  713.      Enables total session logging to the file DEBUG.OUT.  Use this to
  714.      record door activity for later review.
  715.  
  716. SET OVCRT=ON
  717.      This environment enables a special CRT update mode that works best
  718.      with TaskView or OmniView systems.
  719.  
  720. SET CAPFILE=filename
  721.      This setting controls the name of the file generated by the ALT-F
  722.      (file out) and SET PRODEBUG=ON functions.  The default file name of
  723.      DEBUGxx.OUT is changed to the specified name.
  724.  
  725. SET COMSPEC=C:\COMMAND.COM
  726.     This environment variable specifies the location and name of your
  727.     current COMMAND.COM and is required if the location of COMMAND.COM
  728.     is not in the current DOS Path.
  729.  
  730. SET PATH=C:\DOS;C:\UTIL;C:\...
  731.      The PATH environment variable is used to locate many of the programs
  732.      called up by KMail.  Please insure  that your  archive utilities and
  733.      protocol driver programs are present in a directory listed in your
  734.      PATH environment.
  735.  
  736. In The Works
  737. ------------
  738.  
  739. Utility to handle Qnet status and view/change user options.
  740.  
  741.  
  742. Acknowledgements
  743. ----------------
  744.  
  745. Special thanks to Bill Walsh, whose system I crashed many times during
  746. early beta testing, and to Jeff Freeman whose eagle eye caught many
  747. potential problems, and to Ken Flower for testing >256 conferences.
  748. And thanks to the many others who played a part in the beta testing
  749. development of Kmail.
  750.  
  751.  
  752. Registration
  753. ------------
  754.  
  755.   Please see the file REGISTER.TXT for registration information.
  756.  
  757.   After receipt of your registration, you  will need to call my BBS  and
  758. obtain a customized KEY file, which will enable any and all features not
  759. available  in  the  evaluation  copy  of  Kmail.    Currently,  the only
  760. limitation is the number of messages allowed per mail packet.
  761.  
  762.   After obtaining your customized KMAIL.KEY file, just place it in  your
  763. KMAIL sub-directory to activate all features.
  764.  
  765.  
  766.                                  Ken Krueger
  767.                                  Twin Peak's BBS
  768.                     303-651-0225 - Hayes Ultra 9600 96 v.32 / v.42bis
  769.